Skip to main content
Version: 5.2

Custom Field Service

This service is used to store and read customer-specific fields and their contents.

LoadCustomFields

This method loads the customer-specific fields and the contents for a transferred master data record.

void LoadCustomFields(  
out TpFault fault,
TpAuthentication authentication,
SourceData sourceData,
Guid sourceDataId,
out ListCustomFieldContentDto> customFieldContent,
out List<CustomFieldDto> customFields);
Needed PermissioncustomFields@access
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
sourceDataDefines the source data (Employee, Project, Task, Customer, ActiveTimeEntry, TimeEntry, Team, Department, Branch, MonthlySummary)
sourceDataIdUnique id of the source data
customFieldContentOutContent of the defined custom fields
customFieldsOutAll custom fields that are defined

ReportCustomFields

This method loads the customer-specific fields and the content for a transferred master data record with the aim of using these fields for reporting.

void ReportCustomFields(  
out TpFault fault,
TpAuthentication authentication,
SourceData sourceData,
Guid sourceDataId,
out List<CustomFieldContentDto> customFieldContent,
out List<CustomFieldDto> customFields);
Needed PermissioncustomFields@report
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
sourceDataDefines the source data (Employee, Project, Task, Customer, ActiveTimeEntry, TimeEntry, Team, Department, Branch, MonthlySummary)
sourceDataIdUnique id of the source data
customFieldContentOutContent of the defined custom fields
customFieldsOutAll custom fields that are defined

SaveCustomFields

This method is used to store customer-specific fields. However, you cannot create new customer-specific fields with this method, you can only fill them.

void SaveCustomFields(  
out TpFault fault,
TpAuthentication authentication,
SourceData sourceData,
Guid sourceDataId,
List<CustomFieldContentDto> customFieldContent);
Needed PermissioncustomFields@access
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
sourceDataDefines the source data (Employee, Project, Task, Customer, ActiveTimeEntry, TimeEntry, Team, Department, Branch, MonthlySummary)
sourceDataIdUnique id of the source data
customFieldContentOutContent of the defined custom fields

LoadCustomFieldDefinitions

This method loads the actual customer-specific fields for processing.

List<CustomFieldDto> LoadCustomFieldDefinitions(  
out TpFault fault,
TpAuthentication authentication,
SourceData sourceData);
Needed PermissioncustomFields@manage
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
sourceDataDefines the source data (Employee, Project, Task, Customer, ActiveTimeEntry, TimeEntry, Team, Department, Branch, MonthlySummary)
Return valueOutAll custom fields that are defined

SaveCustomFieldDefinitions

This method stores the customer-specific fields. This allows new fields to be created and existing field definitions to be adjusted.

void SaveCustomFieldDefinitions(  
out TpFault fault,
TpAuthentication authentication,
SourceData sourceData,
List<CustomFieldDto> customFields);
Needed PermissioncustomFields@manage
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
sourceDataDefines the source data (Employee, Project, Task, Customer, ActiveTimeEntry, TimeEntry, Team, Department, Branch, MonthlySummary)
customFieldsAll custom fields that are defined